home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / dsyev.z / dsyev
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDSSSSYYYYEEEEVVVV((((3333FFFF))))                                                            DDDDSSSSYYYYEEEEVVVV((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DSYEV - compute all eigenvalues and, optionally, eigenvectors of a real
  10.      symmetric matrix A
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE DSYEV( JOBZ, UPLO, N, A, LDA, W, WORK, LWORK, INFO )
  14.  
  15.          CHARACTER     JOBZ, UPLO
  16.  
  17.          INTEGER       INFO, LDA, LWORK, N
  18.  
  19.          DOUBLE        PRECISION A( LDA, * ), W( * ), WORK( * )
  20.  
  21. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  22.      DSYEV computes all eigenvalues and, optionally, eigenvectors of a real
  23.      symmetric matrix A.
  24.  
  25.  
  26. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  27.      JOBZ    (input) CHARACTER*1
  28.              = 'N':  Compute eigenvalues only;
  29.              = 'V':  Compute eigenvalues and eigenvectors.
  30.  
  31.      UPLO    (input) CHARACTER*1
  32.              = 'U':  Upper triangle of A is stored;
  33.              = 'L':  Lower triangle of A is stored.
  34.  
  35.      N       (input) INTEGER
  36.              The order of the matrix A.  N >= 0.
  37.  
  38.      A       (input/output) DOUBLE PRECISION array, dimension (LDA, N)
  39.              On entry, the symmetric matrix A.  If UPLO = 'U', the leading N-
  40.              by-N upper triangular part of A contains the upper triangular
  41.              part of the matrix A.  If UPLO = 'L', the leading N-by-N lower
  42.              triangular part of A contains the lower triangular part of the
  43.              matrix A.  On exit, if JOBZ = 'V', then if INFO = 0, A contains
  44.              the orthonormal eigenvectors of the matrix A.  If JOBZ = 'N',
  45.              then on exit the lower triangle (if UPLO='L') or the upper
  46.              triangle (if UPLO='U') of A, including the diagonal, is
  47.              destroyed.
  48.  
  49.      LDA     (input) INTEGER
  50.              The leading dimension of the array A.  LDA >= max(1,N).
  51.  
  52.      W       (output) DOUBLE PRECISION array, dimension (N)
  53.              If INFO = 0, the eigenvalues in ascending order.
  54.  
  55.      WORK    (workspace/output) DOUBLE PRECISION array, dimension (LWORK)
  56.              On exit, if INFO = 0, WORK(1) returns the optimal LWORK.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDSSSSYYYYEEEEVVVV((((3333FFFF))))                                                            DDDDSSSSYYYYEEEEVVVV((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      LWORK   (input) INTEGER
  75.              The length of the array WORK.  LWORK >= max(1,3*N-1).  For
  76.              optimal efficiency, LWORK >= (NB+2)*N, where NB is the blocksize
  77.              for DSYTRD returned by ILAENV.
  78.  
  79.      INFO    (output) INTEGER
  80.              = 0:  successful exit
  81.              < 0:  if INFO = -i, the i-th argument had an illegal value
  82.              > 0:  if INFO = i, the algorithm failed to converge; i off-
  83.              diagonal elements of an intermediate tridiagonal form did not
  84.              converge to zero.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.